.. _cmlStGetPosition:

cmlStGetPosition 
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

    VT_I4 cmlStGetPosition ([in] VT_I4 BoardId, [in] VT_I4 Channel, 
    [in] VT_I4 Source, [out] VT_PR8 Count)              

DESCRIPTION
`````````````  

- 지정한 채널의 지정한 카운터의 값을 읽어서 반환합니다. 단, 이때 반환되는 값의 단위는 
  논리적 거리입니다.    

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의
  첨두어 cml 가 붙지 않습니다.


PARAMETER
`````````````

▶ BoardId: 사용자가 설정한 디바이스(보드) ID. 
 
▶ Channel : 축(채널) 번호. 축번호는 상수값으로  3번째 채널을 기준 채널로 임의의 채널을 
설정할 수 있습니다. 
 
▶ Source : 대상 카운터 번호. 이 값은 다음의 4가지 값중의 하나이어야 합니다.  

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

    Value, Meaning
    0 또는 cmlCNT_COMM, Command Counter  
    1 또는 cmlCNT_FEED, Feedback Counter 


▶ Count : 전달된 변수를 통해 대상 카운터의 값을 읽어서 논리적 거리 단위로 반환합니다. 

RETURN VALUE
`````````````

+------------+-----------+
|    Value   | Meaning   |
+============+===========+
|    음수    | 수행 실패 |
+------------+-----------+
| ERR_NONE   | 수행 성공 |
+------------+-----------+

SEEALSO
```````````````

.. seealso:: :ref:`cmlStSetPosition`